library(tidyverse)     # for graphing and data cleaning
library(googlesheets4) # for reading googlesheet data
library(lubridate)     # for date manipulation
library(ggthemes)      # for even more plotting themes
library(geofacet)      # for special faceting with US map layout
gs4_deauth()           # To not have to authorize each time you knit.
theme_set(theme_minimal())       # My favorite ggplot() theme :)
#Lisa's garden data
garden_harvest <- read_sheet("https://docs.google.com/spreadsheets/d/1DekSazCzKqPS2jnGhKue7tLxRU3GVL1oxi-4bEM5IWw/edit?usp=sharing") %>% 
  mutate(date = ymd(date))

# Seeds/plants (and other garden supply) costs
supply_costs <- read_sheet("https://docs.google.com/spreadsheets/d/1dPVHwZgR9BxpigbHLnA0U99TtVHHQtUzNB9UR0wvb7o/edit?usp=sharing",
  col_types = "ccccnn")

# Planting dates and locations
plant_date_loc <- read_sheet("https://docs.google.com/spreadsheets/d/11YH0NtXQTncQbUse5wOsTtLSKAiNogjUA21jnX5Pnl4/edit?usp=sharing",
  col_types = "cccnDlc")%>% 
  mutate(date = ymd(date))

# Tidy Tuesday data
kids <- readr::read_csv('https://raw.githubusercontent.com/rfordatascience/tidytuesday/master/data/2020/2020-09-15/kids.csv')

Setting up on GitHub!

Before starting your assignment, you need to get yourself set up on GitHub and make sure GitHub is connected to R Studio. To do that, you should read the instruction (through the “Cloning a repo” section) and watch the video here. Then, do the following (if you get stuck on a step, don’t worry, I will help! You can always get started on the homework and we can figure out the GitHub piece later):

  • Create a repository on GitHub, giving it a nice name so you know it is for the 3rd weekly exercise assignment (follow the instructions in the document/video).
  • Copy the repo name so you can clone it to your computer. In R Studio, go to file –> New project –> Version control –> Git and follow the instructions from the document/video.
  • Download the code from this document and save it in the repository folder/project on your computer.
  • In R Studio, you should then see the .Rmd file in the upper right corner in the Git tab (along with the .Rproj file and probably .gitignore).
  • Check all the boxes of the files in the Git tab and choose commit.
  • In the commit window, write a commit message, something like “Initial upload” would be appropriate, and commit the files.
  • Either click the green up arrow in the commit window or close the commit window and click the green up arrow in the Git tab to push your changes to GitHub.
  • Refresh your GitHub page (online) and make sure the new documents have been pushed out.
  • Back in R Studio, knit the .Rmd file. When you do that, you should have two (as long as you didn’t make any changes to the .Rmd file, in which case you might have three) files show up in the Git tab - an .html file and an .md file. The .md file is something we haven’t seen before and is here because I included keep_md: TRUE in the YAML heading. The .md file is a markdown (NOT R Markdown) file that is an interim step to creating the html file. They are displayed fairly nicely in GitHub, so we want to keep it and look at it there. Click the boxes next to these two files, commit changes (remember to include a commit message), and push them (green up arrow).
  • As you work through your homework, save and commit often, push changes occasionally (maybe after you feel finished with an exercise?), and go check to see what the .md file looks like on GitHub.
  • If you have issues, let me know! This is new to many of you and may not be intuitive at first. But, I promise, you’ll get the hang of it!

Instructions

  • Put your name at the top of the document.

  • For ALL graphs, you should include appropriate labels.

  • Feel free to change the default theme, which I currently have set to theme_minimal().

  • Use good coding practice. Read the short sections on good code with pipes and ggplot2. This is part of your grade!

  • When you are finished with ALL the exercises, uncomment the options at the top so your document looks nicer. Don’t do it before then, or else you might miss some important warnings and messages.

Warm-up exercises with garden data

These exercises will reiterate what you learned in the “Expanding the data wrangling toolkit” tutorial. If you haven’t gone through the tutorial yet, you should do that first.

  1. Summarize the garden_harvest data to find the total harvest weight in pounds for each vegetable and day of week. Display the results so that the vegetables are rows but the days of the week are columns.
garden_harvest2 <- garden_harvest %>% 
  mutate(dayOfWeek = wday(date, label = TRUE)) %>% 
  group_by(dayOfWeek, vegetable) %>% 
  summarize(weightLBs = sum(weight*0.00220462)) %>% 
  pivot_wider(id_cols = vegetable, 
              names_from = dayOfWeek,
              values_from = weightLBs)

garden_harvest2
  1. Summarize the garden_harvest data to find the total harvest in pound for each vegetable variety and then try adding the plot variable from the plant_date_loc table. This will not turn out perfectly. What is the problem? How might you fix it?
garden_harvest3 <- garden_harvest %>% 
  group_by(vegetable, variety) %>% 
  summarize(weightLBs = sum(weight*0.00220462)) %>% 
  left_join(plant_date_loc, 
            by = c("vegetable", "variety")) %>% 
  select(vegetable, weightLBs, plot, variety)

garden_harvest3
  • The main issue with using the join is that the data becomes slightly ungrouped.
  1. I would like to understand how much money I “saved” by gardening, for each vegetable type. Describe how I could use the garden_harvest and supply_cost datasets, along with data from somewhere like this to answer this question. You can answer this in words, referencing various join functions. You don’t need R code but could provide some if it’s helpful.
  • We could add a variable to garden_harvest that prices the seed mix that is used, aka “variety_price”. Then, we can use a left join by vegetable and select only the price of that vegetable and multiply that by the vegetable’s weight in pounds. Next, we could left join garden_harvest and supply_costs by variety. Finally, we could create a variable called money_saved which would subtract the price of the seed from the price_with_tax variable.
  1. Subset the data to tomatoes. Reorder the tomato varieties from smallest to largest first harvest date. Create a barplot of total harvest in pounds for each variety, in the new order.
garden_harvestT <- garden_harvest %>% 
  filter(vegetable == "tomatoes") %>% 
  mutate(variety = fct_reorder(variety, date, min)) %>% 
  group_by(variety) %>% 
  summarize(date, weightLBs = sum(weight*0.00220462))

garden_harvestT %>% 
  ggplot(aes(y = variety)) + 
    geom_bar(fill = "red") + 
    labs(title = "Total Harvest (LBs) in Order of Smallest to Largest First Harvest Date",
         x = "Total Harvest (LBs)",
         y = "Variety")

  1. In the garden_harvest data, create two new variables: one that makes the varieties lowercase and another that finds the length of the variety name. Arrange the data by vegetable and length of variety name (smallest to largest), with one row for each vegetable variety. HINT: use str_to_lower(), str_length(), and distinct().
garden_harvest4 <- garden_harvest %>% 
  mutate(lowVariety = str_to_lower(variety), lowVarLen = str_length(lowVariety)) %>% 
  distinct(vegetable, variety, lowVarLen) %>% 
  arrange(lowVarLen)

garden_harvest4
  1. In the garden_harvest data, find all distinct vegetable varieties that have “er” or “ar” in their name. HINT: str_detect() with an “or” statement (use the | for “or”) and distinct().
garden_harvest5 <- garden_harvest %>% 
  mutate(hasERAR = str_detect(variety, "ar") | str_detect(variety, "er")) %>% 
  distinct(variety, hasERAR)

garden_harvest5

Bicycle-Use Patterns

In this activity, you’ll examine some factors that may influence the use of bicycles in a bike-renting program. The data come from Washington, DC and cover the last quarter of 2014.

A typical Capital Bikeshare station. This one is at Florida and California, next to Pleasant Pops.{300px}

One of the vans used to redistribute bicycles to different stations.{300px}

Two data tables are available:

  • Trips contains records of individual rentals
  • Stations gives the locations of the bike rental stations

Here is the code to read in the data. We do this a little differently than usualy, which is why it is included here rather than at the top of this file. To avoid repeatedly re-reading the files, start the data import chunk with {r cache = TRUE} rather than the usual {r}.

data_site <- 
  "https://www.macalester.edu/~dshuman1/data/112/2014-Q4-Trips-History-Data.rds" 
Trips <- readRDS(gzcon(url(data_site)))
Stations<-read_csv("http://www.macalester.edu/~dshuman1/data/112/DC-Stations.csv")

NOTE: The Trips data table is a random subset of 10,000 trips from the full quarterly data. Start with this small data table to develop your analysis commands. When you have this working well, you should access the full data set of more than 600,000 events by removing -Small from the name of the data_site.

Temporal patterns

It’s natural to expect that bikes are rented more at some times of day, some days of the week, some months of the year than others. The variable sdate gives the time (including the date) that the rental started. Make the following plots and interpret them:

  1. A density plot, which is a smoothed out histogram, of the events versus sdate. Use geom_density().
Trips %>% 
  ggplot(aes(x = sdate)) + 
  geom_density(color = "blue", fill = "lightblue") +
  labs(title = "Distribution of Rides over Three Months",
       x = "Date",
       y = "Ride Distribution")

  • This density plot shows the distribution of rides over October, November, and December. What we see here is that the majority of rides happened throughout october, with a steep decline from the beginning to the middle of November. It eventually levels off for the first half of December and then declines again.
  1. A density plot of the events versus time of day. You can use mutate() with lubridate’s hour() and minute() functions to extract the hour of the day and minute within the hour from sdate. Hint: A minute is 1/60 of an hour, so create a variable where 3:30 is 3.5 and 3:45 is 3.75.
Trips2 <- Trips %>% 
  mutate(timeOfDay = hour(sdate) + (minute(sdate))/60)

Trips2 %>% 
  ggplot(aes(x = timeOfDay)) + 
  geom_density(color = "black", fill = "yellow") + 
  labs(title = "Density of Rides by Hour of the Day",
       x = "Hour of the Day",
       y = "Density")

  • This plot shows that the majority of rides come at around 8 am and 5 pm, which makes sense because that is the beginning and the end of the work day. There is also a slight bump at 12 pm, which is probably due to people starting rides to go get lunch.
  1. A bar graph of the events versus day of the week. Put day on the y-axis.
Trips2 <- Trips2 %>%
  mutate(day = wday(sdate, label = TRUE))

Trips2 %>% 
  ggplot(aes(y = day)) +
  geom_bar(fill = "orange") + 
  labs(title = "Number of Rides by Day of the Week",
       x = "Number of Rides",
       y = "Day")

  1. Facet your graph from exercise 8. by day of the week. Is there a pattern?
Trips2 %>% 
  ggplot(aes(x = timeOfDay)) + 
  geom_density(color = "black", fill = "yellow") + 
  facet_wrap(~day) +
  labs(title = "Density of Rides by Hour of the Day, Faceted by Day of the Week",
       x = "Hour of the Day",
       y = "Density")

  • The trend for the weekdays are all basically the same, while the two weekend days are the same as each other.

The variable client describes whether the renter is a regular user (level Registered) or has not joined the bike-rental organization (Causal). The next set of exercises investigate whether these two different categories of users show different rental behavior and how client interacts with the patterns you found in the previous exercises. Repeat the graphic from Exercise @ref(exr:exr-temp) (d) with the following changes:

  1. Change the graph from exercise 10 to set the fill aesthetic for geom_density() to the client variable. You should also set alpha = .5 for transparency and color=NA to suppress the outline of the density function.
Trips2 %>% 
  ggplot(aes(x = timeOfDay, fill = client)) + 
  geom_density(color = NA, alpha = .5) + 
  facet_wrap(~day) +
  labs(title = "Density of Rides by Hour of the Day, Faceted by Day of the Week",
       x = "Hour of the Day",
       y = "Density")

  • Here, we can see that the registered riders are the ones who most likely bike to work/school every weekday at the same time. Meanwhile, the causual rider usually takes a bike out for an afternoon ride.
  1. Change the previous graph by adding the argument position = position_stack() to geom_density(). In your opinion, is this better or worse in terms of telling a story? What are the advantages/disadvantages of each?
Trips2 %>% 
  ggplot(aes(x = timeOfDay, fill = client)) + 
  geom_density(color = NA, alpha = .5, position = position_stack()) + 
  facet_wrap(~day) +
  labs(title = "Density of Rides by Hour per Client Type, Faceted by Day of the Week",
       x = "Hour of the Day",
       y = "Density")

  • This shows the distribution of riders by hour for both registered and casual clients combined by stacking casual on top of registered. By doing this, the area under the two stacked density plots combined is 1. The advantage of this is that it reflects the proportion of registered and casual riders. This makes the story a bit more confusing however, because it makes it more difficult to compare the distributions to each other since when stacked, the two densities follow a very similar trend.
  1. Add a new variable to the dataset called weekend which will be “weekend” if the day is Saturday or Sunday and “weekday” otherwise (HINT: use the ifelse() function and the wday() function from lubridate). Then, update the graph from the previous problem by faceting on the new weekend variable.
Trips2 <- Trips2 %>% 
  mutate(weekend = ifelse(day == c("Sat", "Sun"), "weekend", "weekday"))

Trips2 %>% 
  ggplot(aes(x = timeOfDay, fill = client)) + 
  geom_density(color = NA, alpha = .5, position = position_stack()) + 
  facet_wrap(~weekend) +
  labs(title = "Density of Rides by Hour of the Day, Faceted by Day of the Week",
       x = "Hour of the Day",
       y = "Density")

  • This plot has the same advantages and disadvantages as the last plot, where we are able to see the total distribution but not the individual trends.
  1. Change the graph from the previous problem to facet on client and fill with weekday. What information does this graph tell you that the previous didn’t? Is one graph better than the other?
Trips2 %>% 
  ggplot(aes(x = timeOfDay, fill = weekend)) + 
  geom_density(color = NA, alpha = .5, position = position_stack()) + 
  facet_wrap(~client) +
  labs(title = "Density of Rides by Hour of the Day, Faceted by Day of the Week",
       x = "Hour of the Day",
       y = "Density")

  • Here, we are better able to see the individual trends of each type of rider because we have faceted by rider type. Because of this, I would consider this graph better than the previous one.

Spatial patterns

  1. Use the latitude and longitude variables in Stations to make a visualization of the total number of departures from each station in the Trips data. Use either color or size to show the variation in number of departures. We will improve this plot next week when we learn about maps!
Trips3 <- Trips %>% 
  rename(name = sstation)

Trips3 %>% 
  left_join(Stations, by = "name") %>% 
  group_by(name, lat, long) %>% 
  summarize(numDep = n()) %>% 
  ggplot(aes(x = lat, y = long, color = numDep)) +
    geom_point()

  1. Only 14.4% of the trips in our data are carried out by casual users. Create a plot that shows which area(s) have stations with a much higher percentage of departures by casual users. What patterns do you notice? (Again, we’ll improve this next week when we learn about maps).
TripsC <- Trips %>%
  mutate(name = sstation) %>% 
  left_join(Stations) %>% 
  group_by(name, long, lat) %>% 
  filter(client == "Casual") %>% 
  summarize(perc = (n()/nrow(Stations))*100)

TripsC %>% 
  ggplot(aes(x = long, y = lat, color = perc)) + 
  geom_point() +
  labs(title = "Top 10 Stations by Number of Departures",
       x = "Count", y = "Station")

  • A large majority of the departures come from the Lincoln Memorial station and the Jefferson Dr & 14th St SW station. The other large proportions are from the Smithsonian station and the Jefferson Memorial station. These are main landmarks in DC, so this makes sense.

Spatiotemporal patterns

  1. Make a table with the ten station-date combinations (e.g., 14th & V St., 2014-10-14) with the highest number of departures, sorted from most departures to fewest. Save this to a new dataset and print out the dataset. Hint: as_date(sdate) converts sdate from date-time format to date format.
Trips4 <- Trips %>% 
  mutate(date = as_date(sdate)) %>% 
  group_by(sstation, date) %>% 
  summarize(count = n()) %>% 
  arrange(desc(count)) %>% 
  ungroup() %>% 
  top_n(10, count)
Trips4
  1. Use a join operation to make a table with only those trips whose departures match those top ten station-date combinations from the previous part.
Trips4 %>% 
  mutate(sdate = as_date(date)) %>% 
  left_join(Trips, by = "sdate")
  1. Build on the code from the previous problem (ie. copy that code below and then %>% into the next step.) and group the trips by client type and day of the week (use the name, not the number). Find the proportion of trips by day within each client type (ie. the proportions for all 7 days within each client type add up to 1). Display your results so day of week is a column and there is a column for each client type. Interpret your results.
Trips %>%
  mutate(date = as_date(sdate)) %>%
  inner_join(Trips4,
             by = c("sstation", "date")) %>%
  mutate(days_of_week = wday(sdate, label = TRUE)) %>%
  group_by(client, days_of_week) %>%
  summarize(number_riders = n()) %>%
  mutate(total_prop = number_riders/sum(number_riders)) %>%
  pivot_wider(id_cols = days_of_week,
              names_from = client,
              values_from = total_prop)
  • The registered rider rides more often than the casual rider on every day except for Saturday.

DID YOU REMEMBER TO GO BACK AND CHANGE THIS SET OF EXERCISES TO THE LARGER DATASET? IF NOT, DO THAT NOW.

Challenge problem!

This problem uses the data from the Tidy Tuesday competition this week, kids. If you need to refresh your memory on the data, read about it here.

  1. In this exercise, you are going to try to replicate the graph below, created by Georgios Karamanis. I’m sure you can find the exact code on GitHub somewhere, but DON’T DO THAT! You will only be graded for putting an effort into this problem. So, give it a try and see how far you can get without doing too much googling. HINT: use facet_geo(). The graphic won’t load below since it came from a location on my computer. So, you’ll have to reference the original html on the moodle page to see it.

DID YOU REMEMBER TO UNCOMMENT THE OPTIONS AT THE TOP?

LS0tCnRpdGxlOiAnV2Vla2x5IEV4ZXJjaXNlcyAjMycKYXV0aG9yOiAiQWxleCBEZW56bGVyIgpvdXRwdXQ6IAogIGh0bWxfZG9jdW1lbnQ6CiAgICBrZWVwX21kOiBUUlVFCiAgICB0b2M6IFRSVUUKICAgIHRvY19mbG9hdDogVFJVRQogICAgZGZfcHJpbnQ6IHBhZ2VkCiAgICBjb2RlX2Rvd25sb2FkOiB0cnVlCi0tLQoKCmBgYHtyIHNldHVwLCBpbmNsdWRlPUZBTFNFfQprbml0cjo6b3B0c19jaHVuayRzZXQoZWNobyA9IFRSVUUsIGVycm9yPVRSVUUsIG1lc3NhZ2U9RkFMU0UsIHdhcm5pbmc9RkFMU0UpCmBgYAoKYGBge3IgbGlicmFyaWVzfQpsaWJyYXJ5KHRpZHl2ZXJzZSkgICAgICMgZm9yIGdyYXBoaW5nIGFuZCBkYXRhIGNsZWFuaW5nCmxpYnJhcnkoZ29vZ2xlc2hlZXRzNCkgIyBmb3IgcmVhZGluZyBnb29nbGVzaGVldCBkYXRhCmxpYnJhcnkobHVicmlkYXRlKSAgICAgIyBmb3IgZGF0ZSBtYW5pcHVsYXRpb24KbGlicmFyeShnZ3RoZW1lcykgICAgICAjIGZvciBldmVuIG1vcmUgcGxvdHRpbmcgdGhlbWVzCmxpYnJhcnkoZ2VvZmFjZXQpICAgICAgIyBmb3Igc3BlY2lhbCBmYWNldGluZyB3aXRoIFVTIG1hcCBsYXlvdXQKZ3M0X2RlYXV0aCgpICAgICAgICAgICAjIFRvIG5vdCBoYXZlIHRvIGF1dGhvcml6ZSBlYWNoIHRpbWUgeW91IGtuaXQuCnRoZW1lX3NldCh0aGVtZV9taW5pbWFsKCkpICAgICAgICMgTXkgZmF2b3JpdGUgZ2dwbG90KCkgdGhlbWUgOikKYGBgCgpgYGB7ciBkYXRhfQojTGlzYSdzIGdhcmRlbiBkYXRhCmdhcmRlbl9oYXJ2ZXN0IDwtIHJlYWRfc2hlZXQoImh0dHBzOi8vZG9jcy5nb29nbGUuY29tL3NwcmVhZHNoZWV0cy9kLzFEZWtTYXpDektxUFMyam5HaEt1ZTd0THhSVTNHVkwxb3hpLTRiRU01SVd3L2VkaXQ/dXNwPXNoYXJpbmciKSAlPiUgCiAgbXV0YXRlKGRhdGUgPSB5bWQoZGF0ZSkpCgojIFNlZWRzL3BsYW50cyAoYW5kIG90aGVyIGdhcmRlbiBzdXBwbHkpIGNvc3RzCnN1cHBseV9jb3N0cyA8LSByZWFkX3NoZWV0KCJodHRwczovL2RvY3MuZ29vZ2xlLmNvbS9zcHJlYWRzaGVldHMvZC8xZFBWSHdaZ1I5QnhwaWdiSExuQTBVOTlUdFZISFF0VXpOQjlVUjB3dmI3by9lZGl0P3VzcD1zaGFyaW5nIiwKICBjb2xfdHlwZXMgPSAiY2NjY25uIikKCiMgUGxhbnRpbmcgZGF0ZXMgYW5kIGxvY2F0aW9ucwpwbGFudF9kYXRlX2xvYyA8LSByZWFkX3NoZWV0KCJodHRwczovL2RvY3MuZ29vZ2xlLmNvbS9zcHJlYWRzaGVldHMvZC8xMVlIME50WFFUbmNRYlVzZTV3T3NUdExTS0FpTm9nalVBMjFqblg1UG5sNC9lZGl0P3VzcD1zaGFyaW5nIiwKICBjb2xfdHlwZXMgPSAiY2NjbkRsYyIpJT4lIAogIG11dGF0ZShkYXRlID0geW1kKGRhdGUpKQoKIyBUaWR5IFR1ZXNkYXkgZGF0YQpraWRzIDwtIHJlYWRyOjpyZWFkX2NzdignaHR0cHM6Ly9yYXcuZ2l0aHVidXNlcmNvbnRlbnQuY29tL3Jmb3JkYXRhc2NpZW5jZS90aWR5dHVlc2RheS9tYXN0ZXIvZGF0YS8yMDIwLzIwMjAtMDktMTUva2lkcy5jc3YnKQpgYGAKCiMjIFNldHRpbmcgdXAgb24gR2l0SHViIQoKQmVmb3JlIHN0YXJ0aW5nIHlvdXIgYXNzaWdubWVudCwgeW91IG5lZWQgdG8gZ2V0IHlvdXJzZWxmIHNldCB1cCBvbiBHaXRIdWIgYW5kIG1ha2Ugc3VyZSBHaXRIdWIgaXMgY29ubmVjdGVkIHRvIFIgU3R1ZGlvLiBUbyBkbyB0aGF0LCB5b3Ugc2hvdWxkIHJlYWQgdGhlIGluc3RydWN0aW9uICh0aHJvdWdoIHRoZSAiQ2xvbmluZyBhIHJlcG8iIHNlY3Rpb24pIGFuZCB3YXRjaCB0aGUgdmlkZW8gW2hlcmVdKGh0dHBzOi8vZ2l0aHViLmNvbS9sbGVuZHdheS9naXRodWJfZm9yX2NvbGxhYm9yYXRpb24vYmxvYi9tYXN0ZXIvZ2l0aHViX2Zvcl9jb2xsYWJvcmF0aW9uLm1kKS4gVGhlbiwgZG8gdGhlIGZvbGxvd2luZyAoaWYgeW91IGdldCBzdHVjayBvbiBhIHN0ZXAsIGRvbid0IHdvcnJ5LCBJIHdpbGwgaGVscCEgWW91IGNhbiBhbHdheXMgZ2V0IHN0YXJ0ZWQgb24gdGhlIGhvbWV3b3JrIGFuZCB3ZSBjYW4gZmlndXJlIG91dCB0aGUgR2l0SHViIHBpZWNlIGxhdGVyKToKCiogQ3JlYXRlIGEgcmVwb3NpdG9yeSBvbiBHaXRIdWIsIGdpdmluZyBpdCBhIG5pY2UgbmFtZSBzbyB5b3Uga25vdyBpdCBpcyBmb3IgdGhlIDNyZCB3ZWVrbHkgZXhlcmNpc2UgYXNzaWdubWVudCAoZm9sbG93IHRoZSBpbnN0cnVjdGlvbnMgaW4gdGhlIGRvY3VtZW50L3ZpZGVvKS4gIAoqIENvcHkgdGhlIHJlcG8gbmFtZSBzbyB5b3UgY2FuIGNsb25lIGl0IHRvIHlvdXIgY29tcHV0ZXIuIEluIFIgU3R1ZGlvLCBnbyB0byBmaWxlIC0tPiBOZXcgcHJvamVjdCAtLT4gVmVyc2lvbiBjb250cm9sIC0tPiBHaXQgYW5kIGZvbGxvdyB0aGUgaW5zdHJ1Y3Rpb25zIGZyb20gdGhlIGRvY3VtZW50L3ZpZGVvLiAgCiogRG93bmxvYWQgdGhlIGNvZGUgZnJvbSB0aGlzIGRvY3VtZW50IGFuZCBzYXZlIGl0IGluIHRoZSByZXBvc2l0b3J5IGZvbGRlci9wcm9qZWN0IG9uIHlvdXIgY29tcHV0ZXIuICAKKiBJbiBSIFN0dWRpbywgeW91IHNob3VsZCB0aGVuIHNlZSB0aGUgLlJtZCBmaWxlIGluIHRoZSB1cHBlciByaWdodCBjb3JuZXIgaW4gdGhlIEdpdCB0YWIgKGFsb25nIHdpdGggdGhlIC5ScHJvaiBmaWxlIGFuZCBwcm9iYWJseSAuZ2l0aWdub3JlKS4gIAoqIENoZWNrIGFsbCB0aGUgYm94ZXMgb2YgdGhlIGZpbGVzIGluIHRoZSBHaXQgdGFiIGFuZCBjaG9vc2UgY29tbWl0LiAgCiogSW4gdGhlIGNvbW1pdCB3aW5kb3csIHdyaXRlIGEgY29tbWl0IG1lc3NhZ2UsIHNvbWV0aGluZyBsaWtlICJJbml0aWFsIHVwbG9hZCIgd291bGQgYmUgYXBwcm9wcmlhdGUsIGFuZCBjb21taXQgdGhlIGZpbGVzLiAgCiogRWl0aGVyIGNsaWNrIHRoZSBncmVlbiB1cCBhcnJvdyBpbiB0aGUgY29tbWl0IHdpbmRvdyBvciBjbG9zZSB0aGUgY29tbWl0IHdpbmRvdyBhbmQgY2xpY2sgdGhlIGdyZWVuIHVwIGFycm93IGluIHRoZSBHaXQgdGFiIHRvIHB1c2ggeW91ciBjaGFuZ2VzIHRvIEdpdEh1Yi4gIAoqIFJlZnJlc2ggeW91ciBHaXRIdWIgcGFnZSAob25saW5lKSBhbmQgbWFrZSBzdXJlIHRoZSBuZXcgZG9jdW1lbnRzIGhhdmUgYmVlbiBwdXNoZWQgb3V0LiAgCiogQmFjayBpbiBSIFN0dWRpbywga25pdCB0aGUgLlJtZCBmaWxlLiBXaGVuIHlvdSBkbyB0aGF0LCB5b3Ugc2hvdWxkIGhhdmUgdHdvIChhcyBsb25nIGFzIHlvdSBkaWRuJ3QgbWFrZSBhbnkgY2hhbmdlcyB0byB0aGUgLlJtZCBmaWxlLCBpbiB3aGljaCBjYXNlIHlvdSBtaWdodCBoYXZlIHRocmVlKSBmaWxlcyBzaG93IHVwIGluIHRoZSBHaXQgdGFiIC0gYW4gLmh0bWwgZmlsZSBhbmQgYW4gLm1kIGZpbGUuIFRoZSAubWQgZmlsZSBpcyBzb21ldGhpbmcgd2UgaGF2ZW4ndCBzZWVuIGJlZm9yZSBhbmQgaXMgaGVyZSBiZWNhdXNlIEkgaW5jbHVkZWQgYGtlZXBfbWQ6IFRSVUVgIGluIHRoZSBZQU1MIGhlYWRpbmcuIFRoZSAubWQgZmlsZSBpcyBhIG1hcmtkb3duIChOT1QgUiBNYXJrZG93bikgZmlsZSB0aGF0IGlzIGFuIGludGVyaW0gc3RlcCB0byBjcmVhdGluZyB0aGUgaHRtbCBmaWxlLiBUaGV5IGFyZSBkaXNwbGF5ZWQgZmFpcmx5IG5pY2VseSBpbiBHaXRIdWIsIHNvIHdlIHdhbnQgdG8ga2VlcCBpdCBhbmQgbG9vayBhdCBpdCB0aGVyZS4gQ2xpY2sgdGhlIGJveGVzIG5leHQgdG8gdGhlc2UgdHdvIGZpbGVzLCBjb21taXQgY2hhbmdlcyAocmVtZW1iZXIgdG8gaW5jbHVkZSBhIGNvbW1pdCBtZXNzYWdlKSwgYW5kIHB1c2ggdGhlbSAoZ3JlZW4gdXAgYXJyb3cpLiAgCiogQXMgeW91IHdvcmsgdGhyb3VnaCB5b3VyIGhvbWV3b3JrLCBzYXZlIGFuZCBjb21taXQgb2Z0ZW4sIHB1c2ggY2hhbmdlcyBvY2Nhc2lvbmFsbHkgKG1heWJlIGFmdGVyIHlvdSBmZWVsIGZpbmlzaGVkIHdpdGggYW4gZXhlcmNpc2U/KSwgYW5kIGdvIGNoZWNrIHRvIHNlZSB3aGF0IHRoZSAubWQgZmlsZSBsb29rcyBsaWtlIG9uIEdpdEh1Yi4gIAoqIElmIHlvdSBoYXZlIGlzc3VlcywgbGV0IG1lIGtub3chIFRoaXMgaXMgbmV3IHRvIG1hbnkgb2YgeW91IGFuZCBtYXkgbm90IGJlIGludHVpdGl2ZSBhdCBmaXJzdC4gQnV0LCBJIHByb21pc2UsIHlvdSdsbCBnZXQgdGhlIGhhbmcgb2YgaXQhIAoKCgojIyBJbnN0cnVjdGlvbnMKCiogUHV0IHlvdXIgbmFtZSBhdCB0aGUgdG9wIG9mIHRoZSBkb2N1bWVudC4gCgoqICoqRm9yIEFMTCBncmFwaHMsIHlvdSBzaG91bGQgaW5jbHVkZSBhcHByb3ByaWF0ZSBsYWJlbHMuKiogCgoqIEZlZWwgZnJlZSB0byBjaGFuZ2UgdGhlIGRlZmF1bHQgdGhlbWUsIHdoaWNoIEkgY3VycmVudGx5IGhhdmUgc2V0IHRvIGB0aGVtZV9taW5pbWFsKClgLiAKCiogVXNlIGdvb2QgY29kaW5nIHByYWN0aWNlLiBSZWFkIHRoZSBzaG9ydCBzZWN0aW9ucyBvbiBnb29kIGNvZGUgd2l0aCBbcGlwZXNdKGh0dHBzOi8vc3R5bGUudGlkeXZlcnNlLm9yZy9waXBlcy5odG1sKSBhbmQgW2dncGxvdDJdKGh0dHBzOi8vc3R5bGUudGlkeXZlcnNlLm9yZy9nZ3Bsb3QyLmh0bWwpLiAqKlRoaXMgaXMgcGFydCBvZiB5b3VyIGdyYWRlISoqCgoqIFdoZW4geW91IGFyZSBmaW5pc2hlZCB3aXRoIEFMTCB0aGUgZXhlcmNpc2VzLCB1bmNvbW1lbnQgdGhlIG9wdGlvbnMgYXQgdGhlIHRvcCBzbyB5b3VyIGRvY3VtZW50IGxvb2tzIG5pY2VyLiBEb24ndCBkbyBpdCBiZWZvcmUgdGhlbiwgb3IgZWxzZSB5b3UgbWlnaHQgbWlzcyBzb21lIGltcG9ydGFudCB3YXJuaW5ncyBhbmQgbWVzc2FnZXMuCgoKIyMgV2FybS11cCBleGVyY2lzZXMgd2l0aCBnYXJkZW4gZGF0YQoKVGhlc2UgZXhlcmNpc2VzIHdpbGwgcmVpdGVyYXRlIHdoYXQgeW91IGxlYXJuZWQgaW4gdGhlICJFeHBhbmRpbmcgdGhlIGRhdGEgd3JhbmdsaW5nIHRvb2xraXQiIHR1dG9yaWFsLiBJZiB5b3UgaGF2ZW4ndCBnb25lIHRocm91Z2ggdGhlIHR1dG9yaWFsIHlldCwgeW91IHNob3VsZCBkbyB0aGF0IGZpcnN0LgoKICAxLiBTdW1tYXJpemUgdGhlIGBnYXJkZW5faGFydmVzdGAgZGF0YSB0byBmaW5kIHRoZSB0b3RhbCBoYXJ2ZXN0IHdlaWdodCBpbiBwb3VuZHMgZm9yIGVhY2ggdmVnZXRhYmxlIGFuZCBkYXkgb2Ygd2Vlay4gRGlzcGxheSB0aGUgcmVzdWx0cyBzbyB0aGF0IHRoZSB2ZWdldGFibGVzIGFyZSByb3dzIGJ1dCB0aGUgZGF5cyBvZiB0aGUgd2VlayBhcmUgY29sdW1ucy4KCmBgYHtyfQpnYXJkZW5faGFydmVzdDIgPC0gZ2FyZGVuX2hhcnZlc3QgJT4lIAogIG11dGF0ZShkYXlPZldlZWsgPSB3ZGF5KGRhdGUsIGxhYmVsID0gVFJVRSkpICU+JSAKICBncm91cF9ieShkYXlPZldlZWssIHZlZ2V0YWJsZSkgJT4lIAogIHN1bW1hcml6ZSh3ZWlnaHRMQnMgPSBzdW0od2VpZ2h0KjAuMDAyMjA0NjIpKSAlPiUgCiAgcGl2b3Rfd2lkZXIoaWRfY29scyA9IHZlZ2V0YWJsZSwgCiAgICAgICAgICAgICAgbmFtZXNfZnJvbSA9IGRheU9mV2VlaywKICAgICAgICAgICAgICB2YWx1ZXNfZnJvbSA9IHdlaWdodExCcykKCmdhcmRlbl9oYXJ2ZXN0MgpgYGAKCiAgMi4gU3VtbWFyaXplIHRoZSBgZ2FyZGVuX2hhcnZlc3RgIGRhdGEgdG8gZmluZCB0aGUgdG90YWwgaGFydmVzdCBpbiBwb3VuZCBmb3IgZWFjaCB2ZWdldGFibGUgdmFyaWV0eSBhbmQgdGhlbiB0cnkgYWRkaW5nIHRoZSBgcGxvdGAgdmFyaWFibGUgZnJvbSB0aGUgYHBsYW50X2RhdGVfbG9jYCB0YWJsZS4gVGhpcyB3aWxsIG5vdCB0dXJuIG91dCBwZXJmZWN0bHkuIFdoYXQgaXMgdGhlIHByb2JsZW0/IEhvdyBtaWdodCB5b3UgZml4IGl0PwoKYGBge3J9CmdhcmRlbl9oYXJ2ZXN0MyA8LSBnYXJkZW5faGFydmVzdCAlPiUgCiAgZ3JvdXBfYnkodmVnZXRhYmxlLCB2YXJpZXR5KSAlPiUgCiAgc3VtbWFyaXplKHdlaWdodExCcyA9IHN1bSh3ZWlnaHQqMC4wMDIyMDQ2MikpICU+JSAKICBsZWZ0X2pvaW4ocGxhbnRfZGF0ZV9sb2MsIAogICAgICAgICAgICBieSA9IGMoInZlZ2V0YWJsZSIsICJ2YXJpZXR5IikpICU+JSAKICBzZWxlY3QodmVnZXRhYmxlLCB3ZWlnaHRMQnMsIHBsb3QsIHZhcmlldHkpCgpnYXJkZW5faGFydmVzdDMKYGBgCgogIC0gVGhlIG1haW4gaXNzdWUgd2l0aCB1c2luZyB0aGUgam9pbiBpcyB0aGF0IHRoZSBkYXRhIGJlY29tZXMgc2xpZ2h0bHkgdW5ncm91cGVkLiAKCiAgMy4gSSB3b3VsZCBsaWtlIHRvIHVuZGVyc3RhbmQgaG93IG11Y2ggbW9uZXkgSSAic2F2ZWQiIGJ5IGdhcmRlbmluZywgZm9yIGVhY2ggdmVnZXRhYmxlIHR5cGUuIERlc2NyaWJlIGhvdyBJIGNvdWxkIHVzZSB0aGUgYGdhcmRlbl9oYXJ2ZXN0YCBhbmQgYHN1cHBseV9jb3N0YCBkYXRhc2V0cywgYWxvbmcgd2l0aCBkYXRhIGZyb20gc29tZXdoZXJlIGxpa2UgW3RoaXNdKGh0dHBzOi8vcHJvZHVjdHMud2hvbGVmb29kc21hcmtldC5jb20vc2VhcmNoP3NvcnQ9cmVsZXZhbmNlJnN0b3JlPTEwNTQyKSB0byBhbnN3ZXIgdGhpcyBxdWVzdGlvbi4gWW91IGNhbiBhbnN3ZXIgdGhpcyBpbiB3b3JkcywgcmVmZXJlbmNpbmcgdmFyaW91cyBqb2luIGZ1bmN0aW9ucy4gWW91IGRvbid0IG5lZWQgUiBjb2RlIGJ1dCBjb3VsZCBwcm92aWRlIHNvbWUgaWYgaXQncyBoZWxwZnVsLgogIAogIC0gV2UgY291bGQgYWRkIGEgdmFyaWFibGUgdG8gYGdhcmRlbl9oYXJ2ZXN0YCB0aGF0IHByaWNlcyB0aGUgc2VlZCBtaXggdGhhdCBpcyB1c2VkLCBha2EgInZhcmlldHlfcHJpY2UiLiBUaGVuLCB3ZSBjYW4gdXNlIGEgbGVmdCBqb2luIGJ5IHZlZ2V0YWJsZSBhbmQgc2VsZWN0IG9ubHkgdGhlIHByaWNlIG9mIHRoYXQgdmVnZXRhYmxlIGFuZCBtdWx0aXBseSB0aGF0IGJ5IHRoZSB2ZWdldGFibGUncyB3ZWlnaHQgaW4gcG91bmRzLiBOZXh0LCB3ZSBjb3VsZCBsZWZ0IGpvaW4gYGdhcmRlbl9oYXJ2ZXN0YCBhbmQgYHN1cHBseV9jb3N0c2AgYnkgdmFyaWV0eS4gRmluYWxseSwgd2UgY291bGQgY3JlYXRlIGEgdmFyaWFibGUgY2FsbGVkIG1vbmV5X3NhdmVkIHdoaWNoIHdvdWxkIHN1YnRyYWN0IHRoZSBwcmljZSBvZiB0aGUgc2VlZCBmcm9tIHRoZSBgcHJpY2Vfd2l0aF90YXhgIHZhcmlhYmxlLgoKICA0LiBTdWJzZXQgdGhlIGRhdGEgdG8gdG9tYXRvZXMuIFJlb3JkZXIgdGhlIHRvbWF0byB2YXJpZXRpZXMgZnJvbSBzbWFsbGVzdCB0byBsYXJnZXN0IGZpcnN0IGhhcnZlc3QgZGF0ZS4gQ3JlYXRlIGEgYmFycGxvdCBvZiB0b3RhbCBoYXJ2ZXN0IGluIHBvdW5kcyBmb3IgZWFjaCB2YXJpZXR5LCBpbiB0aGUgbmV3IG9yZGVyLgoKYGBge3J9CmdhcmRlbl9oYXJ2ZXN0VCA8LSBnYXJkZW5faGFydmVzdCAlPiUgCiAgZmlsdGVyKHZlZ2V0YWJsZSA9PSAidG9tYXRvZXMiKSAlPiUgCiAgbXV0YXRlKHZhcmlldHkgPSBmY3RfcmVvcmRlcih2YXJpZXR5LCBkYXRlLCBtaW4pKSAlPiUgCiAgZ3JvdXBfYnkodmFyaWV0eSkgJT4lIAogIHN1bW1hcml6ZShkYXRlLCB3ZWlnaHRMQnMgPSBzdW0od2VpZ2h0KjAuMDAyMjA0NjIpKQoKZ2FyZGVuX2hhcnZlc3RUICU+JSAKICBnZ3Bsb3QoYWVzKHkgPSB2YXJpZXR5KSkgKyAKICAgIGdlb21fYmFyKGZpbGwgPSAicmVkIikgKyAKICAgIGxhYnModGl0bGUgPSAiVG90YWwgSGFydmVzdCAoTEJzKSBpbiBPcmRlciBvZiBTbWFsbGVzdCB0byBMYXJnZXN0IEZpcnN0IEhhcnZlc3QgRGF0ZSIsCiAgICAgICAgIHggPSAiVG90YWwgSGFydmVzdCAoTEJzKSIsCiAgICAgICAgIHkgPSAiVmFyaWV0eSIpCmBgYAoKICA1LiBJbiB0aGUgYGdhcmRlbl9oYXJ2ZXN0YCBkYXRhLCBjcmVhdGUgdHdvIG5ldyB2YXJpYWJsZXM6IG9uZSB0aGF0IG1ha2VzIHRoZSB2YXJpZXRpZXMgbG93ZXJjYXNlIGFuZCBhbm90aGVyIHRoYXQgZmluZHMgdGhlIGxlbmd0aCBvZiB0aGUgdmFyaWV0eSBuYW1lLiBBcnJhbmdlIHRoZSBkYXRhIGJ5IHZlZ2V0YWJsZSBhbmQgbGVuZ3RoIG9mIHZhcmlldHkgbmFtZSAoc21hbGxlc3QgdG8gbGFyZ2VzdCksIHdpdGggb25lIHJvdyBmb3IgZWFjaCB2ZWdldGFibGUgdmFyaWV0eS4gSElOVDogdXNlIGBzdHJfdG9fbG93ZXIoKWAsIGBzdHJfbGVuZ3RoKClgLCBhbmQgYGRpc3RpbmN0KClgLgogIApgYGB7cn0KZ2FyZGVuX2hhcnZlc3Q0IDwtIGdhcmRlbl9oYXJ2ZXN0ICU+JSAKICBtdXRhdGUobG93VmFyaWV0eSA9IHN0cl90b19sb3dlcih2YXJpZXR5KSwgbG93VmFyTGVuID0gc3RyX2xlbmd0aChsb3dWYXJpZXR5KSkgJT4lIAogIGRpc3RpbmN0KHZlZ2V0YWJsZSwgdmFyaWV0eSwgbG93VmFyTGVuKSAlPiUgCiAgYXJyYW5nZShsb3dWYXJMZW4pCgpnYXJkZW5faGFydmVzdDQKYGBgCgogIDYuIEluIHRoZSBgZ2FyZGVuX2hhcnZlc3RgIGRhdGEsIGZpbmQgYWxsIGRpc3RpbmN0IHZlZ2V0YWJsZSB2YXJpZXRpZXMgdGhhdCBoYXZlICJlciIgb3IgImFyIiBpbiB0aGVpciBuYW1lLiBISU5UOiBgc3RyX2RldGVjdCgpYCB3aXRoIGFuICJvciIgc3RhdGVtZW50ICh1c2UgdGhlIHwgZm9yICJvciIpIGFuZCBgZGlzdGluY3QoKWAuCgpgYGB7cn0KZ2FyZGVuX2hhcnZlc3Q1IDwtIGdhcmRlbl9oYXJ2ZXN0ICU+JSAKICBtdXRhdGUoaGFzRVJBUiA9IHN0cl9kZXRlY3QodmFyaWV0eSwgImFyIikgfCBzdHJfZGV0ZWN0KHZhcmlldHksICJlciIpKSAlPiUgCiAgZGlzdGluY3QodmFyaWV0eSwgaGFzRVJBUikKCmdhcmRlbl9oYXJ2ZXN0NQpgYGAKCgojIyBCaWN5Y2xlLVVzZSBQYXR0ZXJucwoKSW4gdGhpcyBhY3Rpdml0eSwgeW91J2xsIGV4YW1pbmUgc29tZSBmYWN0b3JzIHRoYXQgbWF5IGluZmx1ZW5jZSB0aGUgdXNlIG9mIGJpY3ljbGVzIGluIGEgYmlrZS1yZW50aW5nIHByb2dyYW0uICBUaGUgZGF0YSBjb21lIGZyb20gV2FzaGluZ3RvbiwgREMgYW5kIGNvdmVyIHRoZSBsYXN0IHF1YXJ0ZXIgb2YgMjAxNC4KCjxjZW50ZXI+CgohW0EgdHlwaWNhbCBDYXBpdGFsIEJpa2VzaGFyZSBzdGF0aW9uLiBUaGlzIG9uZSBpcyBhdCBGbG9yaWRhIGFuZCBDYWxpZm9ybmlhLCBuZXh0IHRvIFBsZWFzYW50IFBvcHMuXShodHRwczovL3d3dy5tYWNhbGVzdGVyLmVkdS9+ZHNodW1hbjEvZGF0YS8xMTIvYmlrZV9zdGF0aW9uLmpwZyl7MzAwcHh9CgoKIVtPbmUgb2YgdGhlIHZhbnMgdXNlZCB0byByZWRpc3RyaWJ1dGUgYmljeWNsZXMgdG8gZGlmZmVyZW50IHN0YXRpb25zLl0oaHR0cHM6Ly93d3cubWFjYWxlc3Rlci5lZHUvfmRzaHVtYW4xL2RhdGEvMTEyL2Jpa2VfdmFuLmpwZyl7MzAwcHh9Cgo8L2NlbnRlcj4KClR3byBkYXRhIHRhYmxlcyBhcmUgYXZhaWxhYmxlOgoKLSBgVHJpcHNgIGNvbnRhaW5zIHJlY29yZHMgb2YgaW5kaXZpZHVhbCByZW50YWxzCi0gYFN0YXRpb25zYCBnaXZlcyB0aGUgbG9jYXRpb25zIG9mIHRoZSBiaWtlIHJlbnRhbCBzdGF0aW9ucwoKSGVyZSBpcyB0aGUgY29kZSB0byByZWFkIGluIHRoZSBkYXRhLiBXZSBkbyB0aGlzIGEgbGl0dGxlIGRpZmZlcmVudGx5IHRoYW4gdXN1YWx5LCB3aGljaCBpcyB3aHkgaXQgaXMgaW5jbHVkZWQgaGVyZSByYXRoZXIgdGhhbiBhdCB0aGUgdG9wIG9mIHRoaXMgZmlsZS4gVG8gYXZvaWQgcmVwZWF0ZWRseSByZS1yZWFkaW5nIHRoZSBmaWxlcywgc3RhcnQgdGhlIGRhdGEgaW1wb3J0IGNodW5rIHdpdGggYHtyIGNhY2hlID0gVFJVRX1gIHJhdGhlciB0aGFuIHRoZSB1c3VhbCBge3J9YC4KCmBgYHtyIGNhY2hlPVRSVUV9CmRhdGFfc2l0ZSA8LSAKICAiaHR0cHM6Ly93d3cubWFjYWxlc3Rlci5lZHUvfmRzaHVtYW4xL2RhdGEvMTEyLzIwMTQtUTQtVHJpcHMtSGlzdG9yeS1EYXRhLnJkcyIgClRyaXBzIDwtIHJlYWRSRFMoZ3pjb24odXJsKGRhdGFfc2l0ZSkpKQpTdGF0aW9uczwtcmVhZF9jc3YoImh0dHA6Ly93d3cubWFjYWxlc3Rlci5lZHUvfmRzaHVtYW4xL2RhdGEvMTEyL0RDLVN0YXRpb25zLmNzdiIpCmBgYAoKKipOT1RFOioqIFRoZSBgVHJpcHNgIGRhdGEgdGFibGUgaXMgYSByYW5kb20gc3Vic2V0IG9mIDEwLDAwMCB0cmlwcyBmcm9tIHRoZSBmdWxsIHF1YXJ0ZXJseSBkYXRhLiBTdGFydCB3aXRoIHRoaXMgc21hbGwgZGF0YSB0YWJsZSB0byBkZXZlbG9wIHlvdXIgYW5hbHlzaXMgY29tbWFuZHMuICoqV2hlbiB5b3UgaGF2ZSB0aGlzIHdvcmtpbmcgd2VsbCwgeW91IHNob3VsZCBhY2Nlc3MgdGhlIGZ1bGwgZGF0YSBzZXQgb2YgbW9yZSB0aGFuIDYwMCwwMDAgZXZlbnRzIGJ5IHJlbW92aW5nIGAtU21hbGxgIGZyb20gdGhlIG5hbWUgb2YgdGhlIGBkYXRhX3NpdGVgLioqCgojIyMgVGVtcG9yYWwgcGF0dGVybnMKCkl0J3MgbmF0dXJhbCB0byBleHBlY3QgdGhhdCBiaWtlcyBhcmUgcmVudGVkIG1vcmUgYXQgc29tZSB0aW1lcyBvZiBkYXksIHNvbWUgZGF5cyBvZiB0aGUgd2Vlaywgc29tZSBtb250aHMgb2YgdGhlIHllYXIgdGhhbiBvdGhlcnMuIFRoZSB2YXJpYWJsZSBgc2RhdGVgIGdpdmVzIHRoZSB0aW1lIChpbmNsdWRpbmcgdGhlIGRhdGUpIHRoYXQgdGhlIHJlbnRhbCBzdGFydGVkLiBNYWtlIHRoZSBmb2xsb3dpbmcgcGxvdHMgYW5kIGludGVycHJldCB0aGVtOgoKICA3LiBBIGRlbnNpdHkgcGxvdCwgd2hpY2ggaXMgYSBzbW9vdGhlZCBvdXQgaGlzdG9ncmFtLCBvZiB0aGUgZXZlbnRzIHZlcnN1cyBgc2RhdGVgLiBVc2UgYGdlb21fZGVuc2l0eSgpYC4KICAKYGBge3J9ClRyaXBzICU+JSAKICBnZ3Bsb3QoYWVzKHggPSBzZGF0ZSkpICsgCiAgZ2VvbV9kZW5zaXR5KGNvbG9yID0gImJsdWUiLCBmaWxsID0gImxpZ2h0Ymx1ZSIpICsKICBsYWJzKHRpdGxlID0gIkRpc3RyaWJ1dGlvbiBvZiBSaWRlcyBvdmVyIFRocmVlIE1vbnRocyIsCiAgICAgICB4ID0gIkRhdGUiLAogICAgICAgeSA9ICJSaWRlIERpc3RyaWJ1dGlvbiIpCmBgYAogIAogIC0gVGhpcyBkZW5zaXR5IHBsb3Qgc2hvd3MgdGhlIGRpc3RyaWJ1dGlvbiBvZiByaWRlcyBvdmVyIE9jdG9iZXIsIE5vdmVtYmVyLCBhbmQgRGVjZW1iZXIuIFdoYXQgd2Ugc2VlIGhlcmUgaXMgdGhhdCB0aGUgbWFqb3JpdHkgb2YgcmlkZXMgaGFwcGVuZWQgdGhyb3VnaG91dCBvY3RvYmVyLCB3aXRoIGEgc3RlZXAgZGVjbGluZSBmcm9tIHRoZSBiZWdpbm5pbmcgdG8gdGhlIG1pZGRsZSBvZiBOb3ZlbWJlci4gSXQgZXZlbnR1YWxseSBsZXZlbHMgb2ZmIGZvciB0aGUgZmlyc3QgaGFsZiBvZiBEZWNlbWJlciBhbmQgdGhlbiBkZWNsaW5lcyBhZ2Fpbi4gCiAgCiAgOC4gQSBkZW5zaXR5IHBsb3Qgb2YgdGhlIGV2ZW50cyB2ZXJzdXMgdGltZSBvZiBkYXkuICBZb3UgY2FuIHVzZSBgbXV0YXRlKClgIHdpdGggYGx1YnJpZGF0ZWAncyAgYGhvdXIoKWAgYW5kIGBtaW51dGUoKWAgZnVuY3Rpb25zIHRvIGV4dHJhY3QgdGhlIGhvdXIgb2YgdGhlIGRheSBhbmQgbWludXRlIHdpdGhpbiB0aGUgaG91ciBmcm9tIGBzZGF0ZWAuIEhpbnQ6IEEgbWludXRlIGlzIDEvNjAgb2YgYW4gaG91ciwgc28gY3JlYXRlIGEgdmFyaWFibGUgd2hlcmUgMzozMCBpcyAzLjUgYW5kIDM6NDUgaXMgMy43NS4KICAKYGBge3J9ClRyaXBzMiA8LSBUcmlwcyAlPiUgCiAgbXV0YXRlKHRpbWVPZkRheSA9IGhvdXIoc2RhdGUpICsgKG1pbnV0ZShzZGF0ZSkpLzYwKQoKVHJpcHMyICU+JSAKICBnZ3Bsb3QoYWVzKHggPSB0aW1lT2ZEYXkpKSArIAogIGdlb21fZGVuc2l0eShjb2xvciA9ICJibGFjayIsIGZpbGwgPSAieWVsbG93IikgKyAKICBsYWJzKHRpdGxlID0gIkRlbnNpdHkgb2YgUmlkZXMgYnkgSG91ciBvZiB0aGUgRGF5IiwKICAgICAgIHggPSAiSG91ciBvZiB0aGUgRGF5IiwKICAgICAgIHkgPSAiRGVuc2l0eSIpCmBgYAogIAogIC0gVGhpcyBwbG90IHNob3dzIHRoYXQgdGhlIG1ham9yaXR5IG9mIHJpZGVzIGNvbWUgYXQgYXJvdW5kIDggYW0gYW5kIDUgcG0sIHdoaWNoIG1ha2VzIHNlbnNlIGJlY2F1c2UgdGhhdCBpcyB0aGUgYmVnaW5uaW5nIGFuZCB0aGUgZW5kIG9mIHRoZSB3b3JrIGRheS4gVGhlcmUgaXMgYWxzbyBhIHNsaWdodCBidW1wIGF0IDEyIHBtLCB3aGljaCBpcyBwcm9iYWJseSBkdWUgdG8gcGVvcGxlIHN0YXJ0aW5nIHJpZGVzIHRvIGdvIGdldCBsdW5jaC4KICAKICA5LiBBIGJhciBncmFwaCBvZiB0aGUgZXZlbnRzIHZlcnN1cyBkYXkgb2YgdGhlIHdlZWsuIFB1dCBkYXkgb24gdGhlIHktYXhpcy4KICAKYGBge3J9ClRyaXBzMiA8LSBUcmlwczIgJT4lCiAgbXV0YXRlKGRheSA9IHdkYXkoc2RhdGUsIGxhYmVsID0gVFJVRSkpCgpUcmlwczIgJT4lIAogIGdncGxvdChhZXMoeSA9IGRheSkpICsKICBnZW9tX2JhcihmaWxsID0gIm9yYW5nZSIpICsgCiAgbGFicyh0aXRsZSA9ICJOdW1iZXIgb2YgUmlkZXMgYnkgRGF5IG9mIHRoZSBXZWVrIiwKICAgICAgIHggPSAiTnVtYmVyIG9mIFJpZGVzIiwKICAgICAgIHkgPSAiRGF5IikKYGBgCiAgCiAgMTAuIEZhY2V0IHlvdXIgZ3JhcGggZnJvbSBleGVyY2lzZSA4LiBieSBkYXkgb2YgdGhlIHdlZWsuIElzIHRoZXJlIGEgcGF0dGVybj8KICAKYGBge3J9ClRyaXBzMiAlPiUgCiAgZ2dwbG90KGFlcyh4ID0gdGltZU9mRGF5KSkgKyAKICBnZW9tX2RlbnNpdHkoY29sb3IgPSAiYmxhY2siLCBmaWxsID0gInllbGxvdyIpICsgCiAgZmFjZXRfd3JhcCh+ZGF5KSArCiAgbGFicyh0aXRsZSA9ICJEZW5zaXR5IG9mIFJpZGVzIGJ5IEhvdXIgb2YgdGhlIERheSwgRmFjZXRlZCBieSBEYXkgb2YgdGhlIFdlZWsiLAogICAgICAgeCA9ICJIb3VyIG9mIHRoZSBEYXkiLAogICAgICAgeSA9ICJEZW5zaXR5IikKYGBgCiAgCiAgLSBUaGUgdHJlbmQgZm9yIHRoZSB3ZWVrZGF5cyBhcmUgYWxsIGJhc2ljYWxseSB0aGUgc2FtZSwgd2hpbGUgdGhlIHR3byB3ZWVrZW5kIGRheXMgYXJlIHRoZSBzYW1lIGFzIGVhY2ggb3RoZXIuIAogIApUaGUgdmFyaWFibGUgYGNsaWVudGAgZGVzY3JpYmVzIHdoZXRoZXIgdGhlIHJlbnRlciBpcyBhIHJlZ3VsYXIgdXNlciAobGV2ZWwgYFJlZ2lzdGVyZWRgKSBvciBoYXMgbm90IGpvaW5lZCB0aGUgYmlrZS1yZW50YWwgb3JnYW5pemF0aW9uIChgQ2F1c2FsYCkuIFRoZSBuZXh0IHNldCBvZiBleGVyY2lzZXMgaW52ZXN0aWdhdGUgd2hldGhlciB0aGVzZSB0d28gZGlmZmVyZW50IGNhdGVnb3JpZXMgb2YgdXNlcnMgc2hvdyBkaWZmZXJlbnQgcmVudGFsIGJlaGF2aW9yIGFuZCBob3cgYGNsaWVudGAgaW50ZXJhY3RzIHdpdGggdGhlIHBhdHRlcm5zIHlvdSBmb3VuZCBpbiB0aGUgcHJldmlvdXMgZXhlcmNpc2VzLiBSZXBlYXQgdGhlIGdyYXBoaWMgZnJvbSBFeGVyY2lzZSBcQHJlZihleHI6ZXhyLXRlbXApIChkKSB3aXRoIHRoZSBmb2xsb3dpbmcgY2hhbmdlczoKCiAgMTEuIENoYW5nZSB0aGUgZ3JhcGggZnJvbSBleGVyY2lzZSAxMCB0byBzZXQgdGhlIGBmaWxsYCBhZXN0aGV0aWMgZm9yIGBnZW9tX2RlbnNpdHkoKWAgdG8gdGhlIGBjbGllbnRgIHZhcmlhYmxlLiBZb3Ugc2hvdWxkIGFsc28gc2V0IGBhbHBoYSA9IC41YCBmb3IgdHJhbnNwYXJlbmN5IGFuZCBgY29sb3I9TkFgIHRvIHN1cHByZXNzIHRoZSBvdXRsaW5lIG9mIHRoZSBkZW5zaXR5IGZ1bmN0aW9uLgogIApgYGB7cn0KVHJpcHMyICU+JSAKICBnZ3Bsb3QoYWVzKHggPSB0aW1lT2ZEYXksIGZpbGwgPSBjbGllbnQpKSArIAogIGdlb21fZGVuc2l0eShjb2xvciA9IE5BLCBhbHBoYSA9IC41KSArIAogIGZhY2V0X3dyYXAofmRheSkgKwogIGxhYnModGl0bGUgPSAiRGVuc2l0eSBvZiBSaWRlcyBieSBIb3VyIG9mIHRoZSBEYXksIEZhY2V0ZWQgYnkgRGF5IG9mIHRoZSBXZWVrIiwKICAgICAgIHggPSAiSG91ciBvZiB0aGUgRGF5IiwKICAgICAgIHkgPSAiRGVuc2l0eSIpCmBgYAogIAogIC0gSGVyZSwgd2UgY2FuIHNlZSB0aGF0IHRoZSByZWdpc3RlcmVkIHJpZGVycyBhcmUgdGhlIG9uZXMgd2hvIG1vc3QgbGlrZWx5IGJpa2UgdG8gd29yay9zY2hvb2wgZXZlcnkgd2Vla2RheSBhdCB0aGUgc2FtZSB0aW1lLiBNZWFud2hpbGUsIHRoZSBjYXVzdWFsIHJpZGVyIHVzdWFsbHkgdGFrZXMgYSBiaWtlIG91dCBmb3IgYW4gYWZ0ZXJub29uIHJpZGUuCgogIDEyLiBDaGFuZ2UgdGhlIHByZXZpb3VzIGdyYXBoIGJ5IGFkZGluZyB0aGUgYXJndW1lbnQgYHBvc2l0aW9uID0gcG9zaXRpb25fc3RhY2soKWAgdG8gYGdlb21fZGVuc2l0eSgpYC4gSW4geW91ciBvcGluaW9uLCBpcyB0aGlzIGJldHRlciBvciB3b3JzZSBpbiB0ZXJtcyBvZiB0ZWxsaW5nIGEgc3Rvcnk/IFdoYXQgYXJlIHRoZSBhZHZhbnRhZ2VzL2Rpc2FkdmFudGFnZXMgb2YgZWFjaD8KICAKYGBge3J9ClRyaXBzMiAlPiUgCiAgZ2dwbG90KGFlcyh4ID0gdGltZU9mRGF5LCBmaWxsID0gY2xpZW50KSkgKyAKICBnZW9tX2RlbnNpdHkoY29sb3IgPSBOQSwgYWxwaGEgPSAuNSwgcG9zaXRpb24gPSBwb3NpdGlvbl9zdGFjaygpKSArIAogIGZhY2V0X3dyYXAofmRheSkgKwogIGxhYnModGl0bGUgPSAiRGVuc2l0eSBvZiBSaWRlcyBieSBIb3VyIHBlciBDbGllbnQgVHlwZSwgRmFjZXRlZCBieSBEYXkgb2YgdGhlIFdlZWsiLAogICAgICAgeCA9ICJIb3VyIG9mIHRoZSBEYXkiLAogICAgICAgeSA9ICJEZW5zaXR5IikKYGBgCiAgCiAgLSAgVGhpcyBzaG93cyB0aGUgZGlzdHJpYnV0aW9uIG9mIHJpZGVycyBieSBob3VyIGZvciBib3RoIHJlZ2lzdGVyZWQgYW5kIGNhc3VhbCBjbGllbnRzIGNvbWJpbmVkIGJ5IHN0YWNraW5nIGNhc3VhbCBvbiB0b3Agb2YgcmVnaXN0ZXJlZC4gQnkgZG9pbmcgdGhpcywgdGhlIGFyZWEgdW5kZXIgdGhlIHR3byBzdGFja2VkIGRlbnNpdHkgcGxvdHMgY29tYmluZWQgaXMgMS4gVGhlIGFkdmFudGFnZSBvZiB0aGlzIGlzIHRoYXQgaXQgcmVmbGVjdHMgdGhlIHByb3BvcnRpb24gb2YgcmVnaXN0ZXJlZCBhbmQgY2FzdWFsIHJpZGVycy4gVGhpcyBtYWtlcyB0aGUgc3RvcnkgYSBiaXQgbW9yZSBjb25mdXNpbmcgaG93ZXZlciwgYmVjYXVzZSBpdCBtYWtlcyBpdCBtb3JlIGRpZmZpY3VsdCB0byBjb21wYXJlIHRoZSBkaXN0cmlidXRpb25zIHRvIGVhY2ggb3RoZXIgc2luY2Ugd2hlbiBzdGFja2VkLCB0aGUgdHdvIGRlbnNpdGllcyBmb2xsb3cgYSB2ZXJ5IHNpbWlsYXIgdHJlbmQuIAogIAogIDEzLiBBZGQgYSBuZXcgdmFyaWFibGUgdG8gdGhlIGRhdGFzZXQgY2FsbGVkIGB3ZWVrZW5kYCB3aGljaCB3aWxsIGJlICJ3ZWVrZW5kIiBpZiB0aGUgZGF5IGlzIFNhdHVyZGF5IG9yIFN1bmRheSBhbmQgICJ3ZWVrZGF5IiBvdGhlcndpc2UgKEhJTlQ6IHVzZSB0aGUgYGlmZWxzZSgpYCBmdW5jdGlvbiBhbmQgdGhlIGB3ZGF5KClgIGZ1bmN0aW9uIGZyb20gYGx1YnJpZGF0ZWApLiBUaGVuLCB1cGRhdGUgdGhlIGdyYXBoIGZyb20gdGhlIHByZXZpb3VzIHByb2JsZW0gYnkgZmFjZXRpbmcgb24gdGhlIG5ldyBgd2Vla2VuZGAgdmFyaWFibGUuIAogIApgYGB7cn0KVHJpcHMyIDwtIFRyaXBzMiAlPiUgCiAgbXV0YXRlKHdlZWtlbmQgPSBpZmVsc2UoZGF5ID09IGMoIlNhdCIsICJTdW4iKSwgIndlZWtlbmQiLCAid2Vla2RheSIpKQoKVHJpcHMyICU+JSAKICBnZ3Bsb3QoYWVzKHggPSB0aW1lT2ZEYXksIGZpbGwgPSBjbGllbnQpKSArIAogIGdlb21fZGVuc2l0eShjb2xvciA9IE5BLCBhbHBoYSA9IC41LCBwb3NpdGlvbiA9IHBvc2l0aW9uX3N0YWNrKCkpICsgCiAgZmFjZXRfd3JhcCh+d2Vla2VuZCkgKwogIGxhYnModGl0bGUgPSAiRGVuc2l0eSBvZiBSaWRlcyBieSBIb3VyIG9mIHRoZSBEYXksIEZhY2V0ZWQgYnkgRGF5IG9mIHRoZSBXZWVrIiwKICAgICAgIHggPSAiSG91ciBvZiB0aGUgRGF5IiwKICAgICAgIHkgPSAiRGVuc2l0eSIpCmBgYAogIAogIC0gVGhpcyBwbG90IGhhcyB0aGUgc2FtZSBhZHZhbnRhZ2VzIGFuZCBkaXNhZHZhbnRhZ2VzIGFzIHRoZSBsYXN0IHBsb3QsIHdoZXJlIHdlIGFyZSBhYmxlIHRvIHNlZSB0aGUgdG90YWwgZGlzdHJpYnV0aW9uIGJ1dCBub3QgdGhlIGluZGl2aWR1YWwgdHJlbmRzLiAKICAKICAxNC4gQ2hhbmdlIHRoZSBncmFwaCBmcm9tIHRoZSBwcmV2aW91cyBwcm9ibGVtIHRvIGZhY2V0IG9uIGBjbGllbnRgIGFuZCBmaWxsIHdpdGggYHdlZWtkYXlgLiBXaGF0IGluZm9ybWF0aW9uIGRvZXMgdGhpcyBncmFwaCB0ZWxsIHlvdSB0aGF0IHRoZSBwcmV2aW91cyBkaWRuJ3Q/IElzIG9uZSBncmFwaCBiZXR0ZXIgdGhhbiB0aGUgb3RoZXI/CiAgCmBgYHtyfQpUcmlwczIgJT4lIAogIGdncGxvdChhZXMoeCA9IHRpbWVPZkRheSwgZmlsbCA9IHdlZWtlbmQpKSArIAogIGdlb21fZGVuc2l0eShjb2xvciA9IE5BLCBhbHBoYSA9IC41LCBwb3NpdGlvbiA9IHBvc2l0aW9uX3N0YWNrKCkpICsgCiAgZmFjZXRfd3JhcCh+Y2xpZW50KSArCiAgbGFicyh0aXRsZSA9ICJEZW5zaXR5IG9mIFJpZGVzIGJ5IEhvdXIgb2YgdGhlIERheSwgRmFjZXRlZCBieSBEYXkgb2YgdGhlIFdlZWsiLAogICAgICAgeCA9ICJIb3VyIG9mIHRoZSBEYXkiLAogICAgICAgeSA9ICJEZW5zaXR5IikKYGBgCiAgCiAgLSBIZXJlLCB3ZSBhcmUgYmV0dGVyIGFibGUgdG8gc2VlIHRoZSBpbmRpdmlkdWFsIHRyZW5kcyBvZiBlYWNoIHR5cGUgb2YgcmlkZXIgYmVjYXVzZSB3ZSBoYXZlIGZhY2V0ZWQgYnkgcmlkZXIgdHlwZS4gQmVjYXVzZSBvZiB0aGlzLCBJIHdvdWxkIGNvbnNpZGVyIHRoaXMgZ3JhcGggYmV0dGVyIHRoYW4gdGhlIHByZXZpb3VzIG9uZS4KICAKIyMjIFNwYXRpYWwgcGF0dGVybnMKCiAgMTUuIFVzZSB0aGUgbGF0aXR1ZGUgYW5kIGxvbmdpdHVkZSB2YXJpYWJsZXMgaW4gYFN0YXRpb25zYCB0byBtYWtlIGEgdmlzdWFsaXphdGlvbiBvZiB0aGUgdG90YWwgbnVtYmVyIG9mIGRlcGFydHVyZXMgZnJvbSBlYWNoIHN0YXRpb24gaW4gdGhlIGBUcmlwc2AgZGF0YS4gVXNlIGVpdGhlciBjb2xvciBvciBzaXplIHRvIHNob3cgdGhlIHZhcmlhdGlvbiBpbiBudW1iZXIgb2YgZGVwYXJ0dXJlcy4gV2Ugd2lsbCBpbXByb3ZlIHRoaXMgcGxvdCBuZXh0IHdlZWsgd2hlbiB3ZSBsZWFybiBhYm91dCBtYXBzIQogIApgYGB7cn0KVHJpcHMzIDwtIFRyaXBzICU+JSAKICByZW5hbWUobmFtZSA9IHNzdGF0aW9uKQoKVHJpcHMzICU+JSAKICBsZWZ0X2pvaW4oU3RhdGlvbnMsIGJ5ID0gIm5hbWUiKSAlPiUgCiAgZ3JvdXBfYnkobmFtZSwgbGF0LCBsb25nKSAlPiUgCiAgc3VtbWFyaXplKG51bURlcCA9IG4oKSkgJT4lIAogIGdncGxvdChhZXMoeCA9IGxhdCwgeSA9IGxvbmcsIGNvbG9yID0gbnVtRGVwKSkgKwogICAgZ2VvbV9wb2ludCgpCmBgYAogIAogIDE2LiBPbmx5IDE0LjQlIG9mIHRoZSB0cmlwcyBpbiBvdXIgZGF0YSBhcmUgY2FycmllZCBvdXQgYnkgY2FzdWFsIHVzZXJzLiBDcmVhdGUgYSBwbG90IHRoYXQgc2hvd3Mgd2hpY2ggYXJlYShzKSBoYXZlIHN0YXRpb25zIHdpdGggYSBtdWNoIGhpZ2hlciBwZXJjZW50YWdlIG9mIGRlcGFydHVyZXMgYnkgY2FzdWFsIHVzZXJzLiBXaGF0IHBhdHRlcm5zIGRvIHlvdSBub3RpY2U/IChBZ2Fpbiwgd2UnbGwgaW1wcm92ZSB0aGlzIG5leHQgd2VlayB3aGVuIHdlIGxlYXJuIGFib3V0IG1hcHMpLgogIApgYGB7cn0KVHJpcHNDIDwtIFRyaXBzICU+JQogIG11dGF0ZShuYW1lID0gc3N0YXRpb24pICU+JSAKICBsZWZ0X2pvaW4oU3RhdGlvbnMpICU+JSAKICBncm91cF9ieShuYW1lLCBsb25nLCBsYXQpICU+JSAKICBmaWx0ZXIoY2xpZW50ID09ICJDYXN1YWwiKSAlPiUgCiAgc3VtbWFyaXplKHBlcmMgPSAobigpL25yb3coU3RhdGlvbnMpKSoxMDApCgpUcmlwc0MgJT4lIAogIGdncGxvdChhZXMoeCA9IGxvbmcsIHkgPSBsYXQsIGNvbG9yID0gcGVyYykpICsgCiAgZ2VvbV9wb2ludCgpICsKICBsYWJzKHRpdGxlID0gIlRvcCAxMCBTdGF0aW9ucyBieSBOdW1iZXIgb2YgRGVwYXJ0dXJlcyIsCiAgICAgICB4ID0gIkNvdW50IiwgeSA9ICJTdGF0aW9uIikKYGBgCiAgCiAgLSBBIGxhcmdlIG1ham9yaXR5IG9mIHRoZSBkZXBhcnR1cmVzIGNvbWUgZnJvbSB0aGUgTGluY29sbiBNZW1vcmlhbCBzdGF0aW9uIGFuZCB0aGUgSmVmZmVyc29uIERyICYgMTR0aCBTdCBTVyBzdGF0aW9uLiBUaGUgb3RoZXIgbGFyZ2UgcHJvcG9ydGlvbnMgYXJlIGZyb20gdGhlIFNtaXRoc29uaWFuIHN0YXRpb24gYW5kIHRoZSBKZWZmZXJzb24gTWVtb3JpYWwgc3RhdGlvbi4gVGhlc2UgYXJlIG1haW4gbGFuZG1hcmtzIGluIERDLCBzbyB0aGlzIG1ha2VzIHNlbnNlLiAKICAKIyMjIFNwYXRpb3RlbXBvcmFsIHBhdHRlcm5zCgogIDE3LiBNYWtlIGEgdGFibGUgd2l0aCB0aGUgdGVuIHN0YXRpb24tZGF0ZSBjb21iaW5hdGlvbnMgKGUuZy4sIDE0dGggJiBWIFN0LiwgMjAxNC0xMC0xNCkgd2l0aCB0aGUgaGlnaGVzdCBudW1iZXIgb2YgZGVwYXJ0dXJlcywgc29ydGVkIGZyb20gbW9zdCBkZXBhcnR1cmVzIHRvIGZld2VzdC4gU2F2ZSB0aGlzIHRvIGEgbmV3IGRhdGFzZXQgYW5kIHByaW50IG91dCB0aGUgZGF0YXNldC4gSGludDogYGFzX2RhdGUoc2RhdGUpYCBjb252ZXJ0cyBgc2RhdGVgIGZyb20gZGF0ZS10aW1lIGZvcm1hdCB0byBkYXRlIGZvcm1hdC4gCiAgCmBgYHtyfQpUcmlwczQgPC0gVHJpcHMgJT4lIAogIG11dGF0ZShkYXRlID0gYXNfZGF0ZShzZGF0ZSkpICU+JSAKICBncm91cF9ieShzc3RhdGlvbiwgZGF0ZSkgJT4lIAogIHN1bW1hcml6ZShjb3VudCA9IG4oKSkgJT4lIAogIGFycmFuZ2UoZGVzYyhjb3VudCkpICU+JSAKICB1bmdyb3VwKCkgJT4lIAogIHRvcF9uKDEwLCBjb3VudCkKVHJpcHM0CmBgYAogIAogIDE4LiBVc2UgYSBqb2luIG9wZXJhdGlvbiB0byBtYWtlIGEgdGFibGUgd2l0aCBvbmx5IHRob3NlIHRyaXBzIHdob3NlIGRlcGFydHVyZXMgbWF0Y2ggdGhvc2UgdG9wIHRlbiBzdGF0aW9uLWRhdGUgY29tYmluYXRpb25zIGZyb20gdGhlIHByZXZpb3VzIHBhcnQuCiAgCmBgYHtyfQpUcmlwczQgJT4lIAogIG11dGF0ZShzZGF0ZSA9IGFzX2RhdGUoZGF0ZSkpICU+JSAKICBsZWZ0X2pvaW4oVHJpcHMsIGJ5ID0gInNkYXRlIikKYGBgCiAgCiAgMTkuIEJ1aWxkIG9uIHRoZSBjb2RlIGZyb20gdGhlIHByZXZpb3VzIHByb2JsZW0gKGllLiBjb3B5IHRoYXQgY29kZSBiZWxvdyBhbmQgdGhlbiAlPiUgaW50byB0aGUgbmV4dCBzdGVwLikgYW5kIGdyb3VwIHRoZSB0cmlwcyBieSBjbGllbnQgdHlwZSBhbmQgZGF5IG9mIHRoZSB3ZWVrICh1c2UgdGhlIG5hbWUsIG5vdCB0aGUgbnVtYmVyKS4gRmluZCB0aGUgcHJvcG9ydGlvbiBvZiB0cmlwcyBieSBkYXkgd2l0aGluIGVhY2ggY2xpZW50IHR5cGUgKGllLiB0aGUgcHJvcG9ydGlvbnMgZm9yIGFsbCA3IGRheXMgd2l0aGluIGVhY2ggY2xpZW50IHR5cGUgYWRkIHVwIHRvIDEpLiBEaXNwbGF5IHlvdXIgcmVzdWx0cyBzbyBkYXkgb2Ygd2VlayBpcyBhIGNvbHVtbiBhbmQgdGhlcmUgaXMgYSBjb2x1bW4gZm9yIGVhY2ggY2xpZW50IHR5cGUuIEludGVycHJldCB5b3VyIHJlc3VsdHMuCgpgYGB7cn0KVHJpcHMgJT4lCiAgbXV0YXRlKGRhdGUgPSBhc19kYXRlKHNkYXRlKSkgJT4lCiAgaW5uZXJfam9pbihUcmlwczQsCiAgICAgICAgICAgICBieSA9IGMoInNzdGF0aW9uIiwgImRhdGUiKSkgJT4lCiAgbXV0YXRlKGRheXNfb2Zfd2VlayA9IHdkYXkoc2RhdGUsIGxhYmVsID0gVFJVRSkpICU+JQogIGdyb3VwX2J5KGNsaWVudCwgZGF5c19vZl93ZWVrKSAlPiUKICBzdW1tYXJpemUobnVtYmVyX3JpZGVycyA9IG4oKSkgJT4lCiAgbXV0YXRlKHRvdGFsX3Byb3AgPSBudW1iZXJfcmlkZXJzL3N1bShudW1iZXJfcmlkZXJzKSkgJT4lCiAgcGl2b3Rfd2lkZXIoaWRfY29scyA9IGRheXNfb2Zfd2VlaywKICAgICAgICAgICAgICBuYW1lc19mcm9tID0gY2xpZW50LAogICAgICAgICAgICAgIHZhbHVlc19mcm9tID0gdG90YWxfcHJvcCkKYGBgCgogIC0gVGhlIHJlZ2lzdGVyZWQgcmlkZXIgcmlkZXMgbW9yZSBvZnRlbiB0aGFuIHRoZSBjYXN1YWwgcmlkZXIgb24gZXZlcnkgZGF5IGV4Y2VwdCBmb3IgU2F0dXJkYXkuIAoKKipESUQgWU9VIFJFTUVNQkVSIFRPIEdPIEJBQ0sgQU5EIENIQU5HRSBUSElTIFNFVCBPRiBFWEVSQ0lTRVMgVE8gVEhFIExBUkdFUiBEQVRBU0VUPyBJRiBOT1QsIERPIFRIQVQgTk9XLioqCgojIyBHaXRIdWIgbGluawoKICAyMC4gQmVsb3csIHByb3ZpZGUgYSBsaW5rIHRvIHlvdXIgR2l0SHViIHBhZ2Ugd2l0aCB0aGlzIHNldCBvZiBXZWVrbHkgRXhlcmNpc2VzLiBTcGVjaWZpY2FsbHksIGlmIHRoZSBuYW1lIG9mIHRoZSBmaWxlIGlzIDAzX2V4ZXJjaXNlcy5SbWQsIHByb3ZpZGUgYSBsaW5rIHRvIHRoZSAwM19leGVyY2lzZXMubWQgZmlsZSwgd2hpY2ggaXMgdGhlIG9uZSB0aGF0IHdpbGwgYmUgbW9zdCByZWFkYWJsZSBvbiBHaXRIdWIuCiAgCiAgW2xpbmtdKGh0dHBzOi8vZ2l0aHViLmNvbS9hbGV4ZGVuemxlci9EZW56bGVyXzAzX2V4ZXJjaXNlcy9ibG9iL21hc3Rlci9EZW56bGVyXzAzX2V4ZXJjaXNlcy5tZCkKCiMjIENoYWxsZW5nZSBwcm9ibGVtISAKClRoaXMgcHJvYmxlbSB1c2VzIHRoZSBkYXRhIGZyb20gdGhlIFRpZHkgVHVlc2RheSBjb21wZXRpdGlvbiB0aGlzIHdlZWssIGBraWRzYC4gSWYgeW91IG5lZWQgdG8gcmVmcmVzaCB5b3VyIG1lbW9yeSBvbiB0aGUgZGF0YSwgcmVhZCBhYm91dCBpdCBbaGVyZV0oaHR0cHM6Ly9naXRodWIuY29tL3Jmb3JkYXRhc2NpZW5jZS90aWR5dHVlc2RheS9ibG9iL21hc3Rlci9kYXRhLzIwMjAvMjAyMC0wOS0xNS9yZWFkbWUubWQpLiAKCiAgMjEuIEluIHRoaXMgZXhlcmNpc2UsIHlvdSBhcmUgZ29pbmcgdG8gdHJ5IHRvIHJlcGxpY2F0ZSB0aGUgZ3JhcGggYmVsb3csIGNyZWF0ZWQgYnkgR2Vvcmdpb3MgS2FyYW1hbmlzLiBJJ20gc3VyZSB5b3UgY2FuIGZpbmQgdGhlIGV4YWN0IGNvZGUgb24gR2l0SHViIHNvbWV3aGVyZSwgYnV0ICoqRE9OJ1QgRE8gVEhBVCEqKiBZb3Ugd2lsbCBvbmx5IGJlIGdyYWRlZCBmb3IgcHV0dGluZyBhbiBlZmZvcnQgaW50byB0aGlzIHByb2JsZW0uIFNvLCBnaXZlIGl0IGEgdHJ5IGFuZCBzZWUgaG93IGZhciB5b3UgY2FuIGdldCB3aXRob3V0IGRvaW5nIHRvbyBtdWNoIGdvb2dsaW5nLiBISU5UOiB1c2UgYGZhY2V0X2dlbygpYC4gVGhlIGdyYXBoaWMgd29uJ3QgbG9hZCBiZWxvdyBzaW5jZSBpdCBjYW1lIGZyb20gYSBsb2NhdGlvbiBvbiBteSBjb21wdXRlci4gU28sIHlvdSdsbCBoYXZlIHRvIHJlZmVyZW5jZSB0aGUgb3JpZ2luYWwgaHRtbCBvbiB0aGUgbW9vZGxlIHBhZ2UgdG8gc2VlIGl0LgogIAoKKipESUQgWU9VIFJFTUVNQkVSIFRPIFVOQ09NTUVOVCBUSEUgT1BUSU9OUyBBVCBUSEUgVE9QPyoqCg==